home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus 2002 #3 / Amiga Plus CD - 2002 - No. 03.iso / AmiSoft / Util / Cli / Howdif.lha / howdif / HowDif.doc < prev   
Text File  |  2003-01-10  |  5KB  |  109 lines
  1. The files in this archive are used to compare binary files. The MS-DOS
  2. "compare" utility only reports ten mismatches, then stops comparing.
  3. It is used primarily when there is an assumption that the two files in
  4. question are most likely identical.
  5.  
  6. We had a use for a program that assumed just the opposite; that the two
  7. files were probably quite a bit dissimilar. We needed to know HOW MUCH
  8. they differed and WHERE. So we wrote this program, which does just that.
  9.  
  10. The program knows the Emerson Arcadia 2001 character set, so is
  11. especially useful for comparing ROM images and hunting for easter eggs
  12. for that system, but the program is also useful for more general
  13. purposes.
  14.  
  15. You use it from the command line. Usage is as follows:
  16.  
  17.     1> HowDif <file1> [<file2>] [-v|VANILLA] [-w|WIDE]
  18.  
  19. where the arguments are the files you wish to compare. For example:
  20.  
  21.     1> HowDif nibble.bin supergob.bin -v WIDE
  22.  
  23. If only one filename is given, the program merely shows a dump of the
  24. file. All output from the program goes to the standard output, and thus
  25. can be piped or redirected as desired.
  26.  
  27. The primary file is whichever of the two files is smaller, or the
  28. first file specified if their sizes are equal. The contents of the
  29. primary file are shown. Bytes which are different in each file are
  30. shown in black (Amiga) or red (MS-DOS). Bytes which are the same in both
  31. files are shown in white (Amiga) or green (MS-DOS).
  32.  
  33. It is "quick-and-dirty". It is also freeware. The authors
  34. included both the executable (object) code and the source code.
  35.  
  36. The MS-DOS version requires ANSI.SYS to be running to get a correct
  37. display. It also has significant limits on the sizes of the files which
  38. can be processed, due to the poor memory architecture of MS-DOS. We
  39. suggest use of the superior Amiga version wherever possible. The AmigaDOS
  40. version has no requirements whatsoever, and should in theory work under
  41. any version of AmigaOS from 1.0 onwards.
  42.  
  43. On the left is the hex dump of the primary file, in the middle is the
  44. ASCII representation of the primary file, and on the right is an Emerson
  45. Arcadia 2001 character set representation of the primary file.
  46.  
  47. The -v option suppresses the emitting of ANSI codes, resulting in
  48. monochrome output.
  49.  
  50. The -w option shows 16 bytes per line rather than the usual 14. The
  51. ASCII representations are not shown in this mode.
  52.  
  53. The ASCII representation shows control characters ($00-$1F and $80-$9F)
  54. as `.'. Note that obviously you will get different ASCII representations
  55. on the Amiga and MS-DOS, due to the differing extended ASCII sets used.
  56.  
  57. The Arcadia uses a 64-character set, shown below. Graphics characters
  58. are represented by lowercase letters.
  59.  
  60.     $0123456789ABCDEF
  61.      ----------------
  62. $00:  /\abcdefghijklm    $00          : space
  63. $10: 0123456789ABCDEF    $01-$0F (/-m): graphics characters
  64. $20: GHIJKLMNOPQRSTUV    $38-$3B (n-q): sprites 0-3
  65. $30: WXYZ.,+$nopqrstu    $3C-$3F (r-u): user defined characters 0-3
  66.  
  67.                                                       $03 (a): ########
  68.                                                                ########
  69.                                                                ########
  70.                                                                ########
  71.                                                                ########
  72.                                                                ########
  73.                                                                ########
  74.                                                                ########
  75.  
  76. $04 (b): ######## $05 (c): ......## $06 (d): ........ $07 (e): ##......
  77.          ########          ......##          ........          ##......
  78.          ........          ......##          ........          ##......
  79.          ........          ......##          ........          ##......
  80.          ........          ......##          ........          ##......
  81.          ........          ......##          ........          ##......
  82.          ........          ......##          ########          ##......
  83.          ........          ......##          ########          ##......
  84.  
  85. $08 (f): ######## $09 (g): ######## $0A (h): ##...... $0B (i): ......##
  86.          ########          ########          ##......          ......##
  87.          ......##          ##......          ##......          ......##
  88.          ......##          ##......          ##......          ......##
  89.          ......##          ##......          ##......          ......##
  90.          ......##          ##......          ##......          ......##
  91.          ......##          ##......          ########          ########
  92.          ......##          ##......          ########          ########
  93.  
  94. $0C (j): .......# $0D (k): #....... $0E (l): ######## $0F (m): ########
  95.          ......##          ##......          #######.          .#######
  96.          .....###          ###.....          ######..          ..######
  97.          ....####          ####....          #####...          ...#####
  98.          ...#####          #####...          ####....          ....####
  99.          ..######          ######..          ###.....          .....###
  100.          .#######          #######.          ##......          ......##
  101.          ########          ########          #.......          .......#
  102.  
  103. URL:   http://www.users.bigpond.com/james.jacobs/amigan.html
  104. EMail: amigansoftware@abime.net
  105.  
  106.                                         Enjoy!
  107.                                         James Jacobs and Ward Shrake
  108.  
  109.